package com.hzsparrow.ai.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.CorsConfigurationSource;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.util.Arrays;

/**
 * 跨域资源共享(CORS)配置类
 * 
 * 该配置类提供了全局的CORS支持，允许前端应用从不同的域名访问后端API。
 * 主要解决浏览器的同源策略限制问题。
 */
@Configuration
public class CorsConfig implements WebMvcConfigurer {

    /**
     * 全局CORS配置
     * 
     * 通过实现WebMvcConfigurer接口的addCorsMappings方法来配置CORS规则
     */
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                // 允许的来源 - 生产环境建议指定具体域名
                .allowedOriginPatterns("*")
                // 允许的HTTP方法
                .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS", "PATCH")
                // 允许的请求头
                .allowedHeaders("*")
                // 是否允许发送Cookie和认证信息
                .allowCredentials(true)
                // 预检请求的缓存时间（秒）
                .maxAge(3600)
                // 暴露给前端的响应头
                .exposedHeaders("Authorization", "Content-Type", "X-Requested-With", "Access-Control-Allow-Origin");
    }

    /**
     * CORS配置源Bean
     * 
     * 提供一个可重用的CORS配置源，可以在其他地方注入使用
     */
    @Bean("webCorsConfigurationSource")
    public CorsConfigurationSource webCorsConfigurationSource() {
        CorsConfiguration configuration = new CorsConfiguration();
        
        // 允许的来源 - 使用allowedOriginPatterns支持通配符
        configuration.setAllowedOriginPatterns(Arrays.asList("*"));
        
        // 允许的HTTP方法
        configuration.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "DELETE", "OPTIONS", "PATCH", "HEAD"));
        
        // 允许的请求头
        configuration.setAllowedHeaders(Arrays.asList("*"));
        
        // 允许发送认证信息
        configuration.setAllowCredentials(true);
        
        // 预检请求的有效期
        configuration.setMaxAge(3600L);
        
        // 暴露给前端的响应头
        configuration.setExposedHeaders(Arrays.asList(
            "Authorization", 
            "Content-Type", 
            "X-Requested-With",
            "Access-Control-Allow-Origin",
            "Access-Control-Allow-Credentials",
            "X-Total-Count"
        ));
        
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", configuration);
        
        return source;
    }
} 